home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / business / dskmlr11.zip / DSKMLR11.DOC < prev    next >
Text File  |  1992-05-14  |  26KB  |  495 lines
  1.  
  2.         (1) The contents of this file:
  3.  
  4.             Portions Copyright 1992 Bryan E. Taylor
  5.             All Rights Reserved  General Technical Data Restricted
  6.             Mailing Address:  4212 Greenlawn
  7.                               Flint  MI 48504 USA
  8.  
  9.             Installation Instructions:
  10.  
  11.             Single and dual floppy disk drive systems:
  12.             1. Get a COMPLETELY blank formatted floppy disk
  13.                {360K MS-DOS(R) format minimum} that is not
  14.                write-protected.  Consult your DOS documentation
  15.                for instructions on formatting floppy disks if
  16.                necessary.
  17.             2. Start up {"boot"} your IBM PC or compatible computer
  18.                from a separate DOS disk or a "bootable" hard disk
  19.                {if any}.
  20.             3. Put the disk containing DSKMLR11.EXE in the computer's
  21.                emptied "A" drive.
  22.             4. Put the blank formatted disk in the computer's
  23.                emptied "B" drive {if any}.
  24.             5. Type "copy a:dskmlr11.exe b:dskmlr11.exe" at the "A>"
  25.                DOS prompt and press the enter key.  Do not type in
  26.                the " 's that enclose the command you give to DOS to
  27.                copy DSKMLR11.EXE to the floppy disk in the "B"
  28.                drive. Single drive users will have to switch disks
  29.                when instructed to do so by DOS {DO NOT INSERT THE
  30.                WRONG DISK AT THE WRONG TIME! (put a write protect
  31.                tab on the original disk containing DSKMLR11.EXE to
  32.                avoid this problem)}.
  33.             6. Type "a:" and press the enter key.
  34.             7. Put disk with the one file DSKMLR11.EXE in the
  35.                emptied "A" drive.
  36.  
  37.             Hard disk drive systems:
  38.             1. Start up {"boot"} your IBM PC or compatible computer
  39.                from a separate DOS disk or a "bootable" hard disk
  40.                      {if any}.
  41.             2. Put the disk containing DSKMLR11.EXE in the computer's
  42.                      emptied "A" drive.
  43.             3. Type "c:" and press the enter key at the DOS prompt
  44.                to change to the hard disk drive {hard disk drive C
  45.                assumed, substitute the letter assigned to your hard
  46.                disk drive if needed}.
  47.             4. Type "cd\" and press the enter key.
  48.             5. Type "md dskmlr" and press the enter key.  I assume
  49.                this subdirectory doesn't allready exist on your
  50.                hard disk. If it does, skip this step.
  51.             6. Type "copy a:dskmlr11.exe c:\dskmlr\dskmlr11.exe"
  52.                and press the enter key.
  53.             7. Type "cd dskmlr" and press the enter key.
  54.  
  55.  
  56.             Startup Instructions:
  57.             Type "dskmlr11" and press the enter key to see program
  58.             instructions, quick-start instructions, disclaimer, and
  59.             licensing and distribution information (see below {it
  60.             has been reformatted}).
  61.  
  62.         (2) usage is:
  63.             DSKMLR11
  64.             DSKMLR11 /MENU[C]
  65.             DSKMLR11 MLR ADR|SRT OUT
  66.             where:
  67.             /MENU[C] - enter interactive mode
  68.                        [with CGA "snow" checking]
  69.             MLR       - disk filename of diskette mailer template
  70.             ADR|SRT   - disk filename of (sorted) mailing address data
  71.             OUT       - filename of output file for the diskette mailers
  72.             {CON=screen | PRN=printer | NUL=no output |
  73.              valid disk filename}
  74.             {all three filenames must be different}
  75.             DISKMAILER 1.1 will not overwrite an existing file on
  76.             disk when making mailers
  77.             DISKMAILER with no command line parameters prints this
  78.             text
  79.             If a (disk) eror occurs while processing, DISKMAILER 1.1
  80.             will print a helpful eror message and continue or exit
  81.             if in command line mode.
  82.  
  83.             Quick-start instructions for those who want to use this
  84.             program right away: To use this program:  1)Copy this
  85.             program onto an empty formatted disk or into an empty
  86.             subdirectory of a hard disk (e.g.
  87.             A>copy A:DSKMLR11.EXE B:DSKMLR11.EXE{enter}
  88.             OR
  89.             C>md DSKMLR{enter}
  90.             C>copy A:DSKMLR11.EXE C:\DSKMLR\DSKMLR11.EXE{enter}).
  91.             2)At the DOS prompt, "unpack" the "files" in DSKMLR11.EXE
  92.             (e.g. A>B:{enter} B>DSKMLR11 /MENU{enter}
  93.             OR
  94.             C>cd DSKMLR{enter}
  95.             C>DSKMLR11 /MENU{enter}
  96.             then press the U key).  3)Press E to edit or use a
  97.             separate text editor or word processor program that can
  98.             save files in "straight" ASCII format to modify the
  99.             files DSKMLR11.TEM and DSKMLR11.ADR to your liking for
  100.             the software program distribution diskettes you intend
  101.             to distribute (see DSKMLR11.TEM and DSKMLR11.ADR for
  102.             information you can use when editing {and later saving}
  103.             these files).  4)Print out the diskette mailers on the
  104.             printer {first make sure there is enough paper and the
  105.             printer is ready or your system may "freeze" up!} with
  106.             DISKMAILER's "print" cmd (e.g.
  107.             B>DSKMLR11 DSKMLR11.tem DSKMLR11.adr prn{enter}
  108.             OR
  109.             C>DSKMLR11 DSKMLR11.tem DSKMLR11.adr prn{enter})
  110.             or press Ctrl-QG in the built-in editor to access this
  111.             feature. 5)Put the diskette mailers together using:
  112.             scissors or HUNT's X-ACTO(R) knife (use with care),
  113.             glue stick {such as FaberCastell(R)'s UHU stic color
  114.             Glue Stick}, transparent adhesive tape {such as 3M's
  115.             SCOTCH(R) brand MAGIC(TM) Tape}, and your formatted
  116.             software program distribution disks according to the
  117.             assembly instructions contained in the DSKMLR11.TEM
  118.             file.  Apply postage and...
  119.  
  120.             YOUR SOFTWARE PROGRAM DISTRIBUTION DISKS ARE NOW READY
  121.             TO BE MAILED!
  122.  
  123.         (3)                    DISCLAIMER
  124.             BRYAN E. TAYLOR ("THE AUTHOR") MAKES NO WARRANTIES
  125.             WHATSOEVER ON THIS SOFTWARE AND THE "FILES" CONTAINED
  126.             THEREIN ("THIS PROGRAM").  ALTHOUGH EVERY EFFORT HAS
  127.             BEEN MADE BY THE AUTHOR TO MAKE THIS PROGRAM AS ERROR
  128.             FREE AS POSSIBLE, UNDER NO CIRCUMSTANCES WHATSOEVER
  129.             SHALL THE AUTHOR BE HELD LIABLE FOR ANY AND ALL DAMAGES
  130.             INCURRED BY YOU RESULTING FROM THE USE OR INABILITY TO
  131.             USE THIS PROGRAM
  132.  
  133.                          SOFTWARE LICENSE AGREEMENT
  134.             The author retains any and all copyright rights to this
  135.             program.  You are allowed to use this program as long as
  136.             needed to determine if this program is a valuable
  137.             addition to your software library. You may make as many
  138.             copies of this program as you need for your personal
  139.             use.  You may use this program on more than one computer
  140.             provided there is no way it will be used on more than
  141.             one computer at the same time.  If you need to use this
  142.             program on more than one computer at the same time,
  143.             please refer to the site license agreement "file" that
  144.             can be "unpacked" from this program.
  145.  
  146.             If you find this program a valuable addition to your
  147.             software library, may I encourage you to register your
  148.             copy?  Your registration will entitle you to receive one
  149.             free copy of the next version on DISKMAILER when it is
  150.             ready that is "preregistered" for the number of users/
  151.             computers previously registered.  Thank you for
  152.             your consideration,  Bryan E. Taylor
  153.                                  4212 Greenlawn
  154.                                  Flint  MI 48504 USA
  155.  
  156.         (4)            SOFTWARE DISTRIBUTION AGREEMENT
  157.             Bryan E. Taylor ("the author") grants permission for
  158.             this program to be copied and made available for
  159.             distribution to others.  If any fee is charged, it must
  160.             be no more than 20.00(U.S. FUNDS) and must be specified
  161.             as "materials,shipping, and handling".  This program
  162.             must be clearly identified as shareware in any media
  163.             this program is distributed or cataloged in and that an
  164.             additional fee must be paid for continued use of this
  165.             program.  Any foreign/domestic software distributor,
  166.             including but not limited to electronic bulletin board
  167.             services, computer clubs, and software disk
  168.             distributors, must distribute this program according to
  169.             the following rules:  1)The distributor must stop
  170.             distributing this program upon written notification from
  171.             the author.  2)This program must not be modified in any
  172.             way although additional files may be added to the
  173.             distribution disks this program is distributed on.
  174.             3)This program may be compressed for space using any
  175.             data compression utility program provided that said
  176.             program and its instructions for its operation and use
  177.             is available for distribution to those who receive this
  178.             program.  4)The distributor must correctly use and
  179.             identify any trademarks that may be contained in this
  180.             program. 5)Provide the author with written notification
  181.             and a software catalog, if available, containing a
  182.             listing of this program as shareware and that it is
  183.             available for distribution to others.  6)The distributor
  184.             must forward any correspondence they receive concerning
  185.             this program to the author.  7)Any foreign/domestic
  186.             software distributor, please contact author about any
  187.             program where registered copies of this program can be
  188.             offered for sale to others.
  189.  
  190.             How to use DISKMAILER 1.1:
  191.             1. Create your working, error-free, software program
  192.                distribution disk and duplicate it as often as
  193.                necessary by using the DOS commands COPY or DISKCOPY
  194.                (use with care). Consult your DOS documentation for
  195.                instructions for using these commands.
  196.  
  197.             2. Type "DSKMLR11 /MENU" or "DSKMLR11 /MENUC" at the
  198.                DOS prompt and press the enter key.
  199.  
  200.             3. Press the letter of the menu choice you want to make.
  201.  
  202.         (5)    E - Enter the built-in editor.
  203.                Use the buit-in editor to modify the .TEM and/or
  204.                .ADR and/or .SRT file(s) to your liking for the
  205.                software program distribution disks you intend to
  206.                distribute.
  207.  
  208.                Feel free to use the built-in editor (in overwrite
  209.                mode) to "fill out" the DSKMLR11.REG and/or
  210.                DSKMLR11.LIC file(s) if you are registering this
  211.                program with the author.
  212.  
  213.                The following editor commands are available and
  214.                based on those found in MICROPRO INTERNATIONAL's
  215.                WORDSTAR(R) word processing program:
  216.                {e.g. ^QB means hold down the Ctrl key and type Q
  217.                 then B and release the Ctrl key}
  218.  
  219.                ^E-cursor up a line
  220.                ^X-cursor down a line
  221.                ^S-cursor left one character
  222.                ^D-cursor right one character
  223.                ^A-cursor left one word {series of nonblank chars}
  224.                ^F-cursor right one word {series of nonblank chars}
  225.                ^W-cursor to begining of line
  226.                ^Z-cursor to end of line
  227.                ^R-cursor up 14 lines
  228.                ^C-cursor down 14 lines
  229.                ^T-cursor up to first line of file
  230.                ^V-cursor down to last line of file
  231.                ^Y-shell to operating system
  232.  
  233.                ^P-enter ASCII character to left of cursor
  234.                {or use the hold Alt-type keypad ASCII code-release Alt
  235.                 method}
  236.                the character may be ignored by the program for good
  237.                reason
  238.  
  239.                ^B-toggle insert/overwrite modes
  240.                ^G-deleting character at cursor and linebreaks
  241.                backspace key-deleting characters and linebreaks
  242.                enter key-goto next line and inserting linebreaks
  243.  
  244.                any other key presses will appear on the screen
  245.                as characters to the left of the cursor or be
  246.                ignored by the program for good reason
  247.  
  248.                Esc-leave the editor and return to the menu
  249.                    {confirmation is requested}
  250.  
  251.                ^QB-goto block begin  ^QP-goto line
  252.                ^QK-goto block end    ^QG-print items from .TEM file
  253.                ^QD-line delete       ^QR-show .ADR/.SRT record
  254.                                          line as an address
  255.                                          for the .TEM items
  256.                ^QI-line insert           in output window
  257.                ^QA-find(/replace)    ^I-display editor commands
  258.                                         in output window
  259.                                      ^U-display editor commands
  260.                                         in output window
  261.  
  262.         (6)    ^KB-set block begin  ^KK-set block end
  263.                A marked block has its starting and ending
  264.                lines displayed on the status line
  265.  
  266.                ^KC-copy block       ^KR-read block
  267.                ^KV-move block       ^KW-write block
  268.                ^KY-delete block     ^KL-load file
  269.                ^KU-unmark block     ^KS-save file
  270.  
  271.  
  272.                U - Unpack built-in files to the current disk
  273.                    directory.  If an error occurs, the program will
  274.                    print an error message and return to DOS.
  275.  
  276.                C - Convert an ASCII formatted $M$ file into
  277.                    ASCII .ADR formatted file(s) (see this command
  278.                    for more information and instructions for use).
  279.  
  280.                D - Convert a {ASHTON-TATE DBASE(R)} .DBF formatted
  281.                    $M$ file into ASCII .ADR formatted file(s) (see
  282.                    this command for more information and
  283.                    instructions for use).
  284.  
  285.                S - Sort .ADR formatted file(s) by zip/postal code
  286.                    into .SRT file(s) in the .ADR format (see this
  287.                    command for more information and instructions
  288.                    for use).  This option must be selected AFTER
  289.                    a C or D command and BEFORE the .ADR files are
  290.                    modified so the S command can sort the contents
  291.                    of the .ADR formatted file(s) properly into the
  292.                    .SRT file(s).
  293.  
  294.                Q - leave the menu and return to DOS
  295.                    {confirmation is requested}
  296.  
  297.  
  298.                When a keypress is requested, type one of the keys
  299.                enclosed in parenthesis or the enter key as a
  300.                default keypress for the first choice:
  301.  
  302.                  Confirm block delete (Y)es/(N)o?
  303.                  {press Y for yes or N for no}
  304.  
  305.                  Is this string correct [cr]|(Y)es/(N)o?
  306.                  {press enter key or Y for yes or N for no}
  307.  
  308.             4. Make sure that your printer:
  309.               1. Is connected to your computer.
  310.               2. Is turned on.
  311.               3. Is "on line" (ready to print information it
  312.                  receives from the computer).
  313.               4. Has enough paper available to it to print the
  314.                  number of items "tagged" for printing in the
  315.                  DSKMLR11.ADR file.  Otherwise, your system may
  316.                  "freeze" up if the printer runs out of paper while
  317.                  printing the items!
  318.  
  319.         (7) 5. Type "DSKMLR11 DSKMLR11.tem DSKMLR11.adr prn" and
  320.                press the enter key at the DOS prompt (or use the
  321.                ^QG command in the built-in editor) to print the
  322.                desired items on the printer. Make sure that the
  323.                paper in the printer does not jam while printing or
  324.                your system may "freeze" up if the paper jams in the
  325.                printer while printing the items!
  326.  
  327.             6. When you see the DOS system prompt (or the program
  328.                gives you an "OPERATION SUCCESSFUL" message) and the
  329.                printer stops printing, put the printed items together
  330.                using the printed output, scissors/HUNT's
  331.                X-ACTO(R) knife, glue, adhesive tape, software program
  332.                distribution disks, and postage {if needed} according
  333.                to the assembly instructions originally contained in
  334.                the DSKMLR11.TEM file.
  335.  
  336.             7. Your software program distribution disks are now
  337.                ready to be mailed!  Take your completed disk
  338.                mailers to the post office and go inside during
  339.                normal business hours.  Give your completed disk
  340.                mailers to a postal clerk at the customer service
  341.                counter for mailing.
  342.  
  343.             Note: Repeat steps 1 to 7 as needed for the different
  344.                   kinds of software program distribution disks you
  345.                   intend to distribute using DISKMAILER 1.1 And your
  346.                   postal service.
  347.  
  348.             Other useful information for DISKMAILER 1.1 Users:
  349.  
  350.             - IMPORTANT!  DISKMAILER must use bonafide .TEM and .ADR
  351.               files when generating disk mailers or the output will
  352.               be unpredictable!  Print the disk mailers to the
  353.               screen (DISKMAILER output "file" of "con") to be sure
  354.               the expected output that appears on the screen will
  355.               appear on the paper when printed by the printer (the
  356.               first line of certain pages will be "crooked" due to
  357.               the output printing status that is printed on the
  358.               screen as the mailers are printed).  The status
  359.               information is updated on the screen for every line in
  360.               the .ADR/.SRT file that is read and for every item in
  361.               the mailer template file that is printed.
  362.  
  363.             - For "unattended" operation, The program can be used in
  364.               batch files with 0 or 3 parameters and will return an
  365.               errorlevel of 1 if an error occured else 0.
  366.  
  367.             - Feel free to print "dummy" disk mailers with their
  368.               assembly instructions intact to get practice putting
  369.               them together.
  370.  
  371.             - Print out and put together the quick-reference disk
  372.               jacket in the DSKMLR11.REF file if you always want
  373.               to have the program instructions handy for the floppy
  374.               disk with the DSKMLR11.EXE program on it.
  375.  
  376.         (8) - Rename DSKMLR11.TEM and DSKMLR11.ADR to any valid
  377.               filename of your liking or create new ones. Just be
  378.               sure that the names of the disk mailer template and
  379.               mailing address files are the first two of the three
  380.               filenames given on the command line of the program
  381.               (or the first two filenames specified for a ^QG
  382.               command in the built-in editor) when it is run to
  383.               create disk mailers.
  384.  
  385.             - DSKMLR11.EXE will print address label lines up to 41
  386.               characters in width.  If the label lines are longer
  387.               than this, the extra characters are not put into the
  388.               disk mailer template when the addresses are put into
  389.               the disk mailer template in the appropriate places.
  390.               To avoid any problems, use the ^QR command in
  391.               program's built-in editor to see how the address will
  392.               look when printed.  Edit the .ADR/.SRT record lines
  393.               and use the ^QR command until the addresses appear the
  394.               way you want them to when they are printed or saved to
  395.               disk in an output file.
  396.  
  397.             - "Shareware" retailers: kiss those small plastic bags
  398.               goodbye and print retail containers for your software
  399.               program distribution disks that are LOADED with
  400.               information to the potential customer.  To do this,
  401.               create a dummy address data file that contain enough
  402.               copies of the following line for the number of
  403.               "retail" disk mailers that you intend to make:
  404.               {replace L1-L5 with desired character strings that
  405.                do not begin with a ~ character and use the _
  406.                character to represent a space in the field and
  407.                do not exceed 41 characters in length (use ASCII
  408.                characters 32-126 for no "surprises" when template
  409.                items are printed on the printer)}
  410.  
  411.               * ~ ~ ~ ~ ~ L5 L4 L3 L1 L2 ~ ~
  412.  
  413.               if DISKMAILER 1.1 uses these lines as "addresses", the
  414.               result is that the above strings are printed in the
  415.               rectangular areas where the $ character is in the disk
  416.               mailer template file.  Therefore, you can edit a .ADR
  417.               and .TEM file to use these blanks areas when creating
  418.               your "retail" disk mailers.  Be sure to confine the text
  419.               that you type into lines 1 through 116 of your "retail"
  420.               disk mailer template file between the innermost right
  421.               and left line of |'s on those lines.  Edit lines 233
  422.               through 290 of the "retail" disk mailer template to
  423.               create the desired floppy disk jacket and label for
  424.               each of your "retail" software program distribution
  425.               disks.  After putting your "retail" disk mailers
  426.               together, you can use a hole punch to punch a hole in
  427.               the middle of one of the glue margins so the "retail"
  428.               disk mailers can be hung on a pegboard.
  429.  
  430.         (9) - COMDEX booth operators: you can use the technique
  431.               described above to create disk mailers you can send to
  432.               the contacts you make at the COMDEX from .TEM/.ADR files
  433.               edited as such.  Pre-print a sufficient supply of disk
  434.               mailers that equal the supply of software program
  435.               distribution disks that you will take with you to the
  436.               COMDEX.  As you make contacts who would be interested
  437.               in receiving your software, you can put a disk mailer
  438.               together to send to them when things are slow and no
  439.               one is at your booth.  At the end of the day...
  440.  
  441.               Your software program distribution disks are now
  442.               ready to be mailed!  Take your completed disk
  443.               mailers to the post office and go inside during
  444.               normal business hours.  Give your completed disk
  445.               mailers to a postal clerk at the customer service
  446.               counter for mailing.
  447.  
  448.             - "Inter-office" ware:  office employees can "mail" their
  449.               disks to others in the office by using the company's
  450.               inter-office mail system.  Below is a sample line from
  451.               an .ADR file that is edited as such (it is printed
  452.               on more than one line below so it can be seen on the
  453.               page without causing "wraparound" if this file is
  454.               printed to the printer with a DOS command
  455.               [e.g. type "copy DSKMLR11.doc prn" and press the enter
  456.               key at the DOS prompt]):
  457.  
  458.               * ~ ~ ~ {USEFUL_INFO} {USEFUL_INFO} {USEFUL_INFO}
  459.                 ROOM_505 6TH_FLOOR ACCOUNTING_DEPT. EMUP AD
  460.                 HEAD_ACCOUNTANT
  461.  
  462.             - Are the possible uses for DISKMAILER "endless"?  These
  463.               were the uses I could come up with.  Please use the
  464.               DSKMLR11.RMK file to share with me any other ways you
  465.               use this program for possible inclusion in this area
  466.               of the documentation file for future versions of
  467.               DISKMAILER.
  468.  
  469.             Acknowledgments
  470.  
  471.             Thanks to:
  472.  
  473.             Jim Hood for allowing me to use part of his $M$ shareware
  474.             software package in this program.
  475.  
  476.             You the user for using DISKMAILER 1.1.
  477.             Please copy and share DSKMLR11.EXE with others.
  478.  
  479.        (10) Version summary
  480.  
  481.             1.0 - Initial pre-release evaluation version, command line only
  482.                   version.
  483.             1.1 - Initial general release version.  Made the
  484.                   following improvements to the previous version:
  485.                   - Added a simple menu system.
  486.                   - Improved the data compression technique for the
  487.                     "internal files".
  488.                   - Added a built-in editor and "point and shoot"
  489.                     file selecting system.
  490.                   - Added 3 routines for data conversion and sorting
  491.                     that are accessed from the program's menu.
  492.                   - Can be run from the command line like
  493.                     version 1.0
  494.  
  495.